Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Types and Constants

Bevel Button and Image Well Content Type Constants

NEW WITH THE APPEARANCE MANAGER

You can use these constants in the contentType field of the bevel button and image well content structure to display resource or handle-based bevel button and image well content, including text, icon suites, color icons, and pictures.

The resource IDs for icon suite, color icon, and picture resources are passed in the maximumValue parameter of NewControl or in a control ('CNTL') resource. The content type is passed in the low byte of the minimumValue parameter of NewControl.

Note

Resource-based content is owned by the control, while handle-based content is owned by you. The control definition function will not dispose of handle-based content. If you replace handle-based content with resource-based content on the fly, you must dispose of the handle properly to avoid a memory leak.

enum {
   kControlContentTextOnly        = 0,
   kControlContentIconSuiteRes    = 1,
   kControlContentCIconRes        = 2,
   kControlContentPictRes         = 3,
   kControlContentIconSuiteHandle = 129,
   kControlContentCIconHandle     = 130,
   kControlContentPictHandle      = 131,
   kControlContentIconRef         = 132
};
typedef SInt16 ControlContentType;

Constant descriptions

kControlContentTextOnly

Content type is text only. This constant is passed in the contentType field of the bevel button and image well content structure if the content is text only. The variation code kControlUsesOwningWindowsFontVariant applies when text content is used.

kControlContentIconSuiteRes

Content type uses an icon suite resource ID. The resource ID of the icon suite resource you wish to display should be in the resID field of the bevel button and image well content structure.

kControlContentCIconRes

Content type is a color icon resource ID. The resource ID of the color icon resource you wish to display should be in the resID field of the bevel button and image well content structure.

kControlContentPictRes

Content type is a picture resource ID. The resource ID of the picture resource you wish to display should be in the resID field of the bevel button and image well content structure.

kControlContentIconSuiteHandle

Content type is an icon suite handle. The handle of the icon suite you wish to display should be in the iconSuite field of the bevel button and image well content structure.

kControlContentCIconHandle

Content type uses a color icon handle. The handle of the color icon you wish to display should be in the cIconHandle field of the bevel button and image well content structure.

kControlContentPictHandle

Content type uses a picture handle. The handle of the picture you wish to display should be in the picture field of the bevel button and image well content structure.

kControlContentIconRef

Reserved. Set to 0.